Welcome to Pesterchum 3.41! ============================= ## FOR NEW USERS This modification of Pesterchum is intended for people who are already familiar with using the base client. If you aren't, please check the standard build's [documentation][pchum-doc]. [pchum-orig]: https://github.com/illuminatedwax/pesterchum [pchum-doc]: https://github.com/illuminatedwax/pesterchum/blob/master/README.mkdn ## FOR EVERYONE ELSE Greetings! This is a modification of Pesterchum, made because Pesterchum is effectively no longer maintained, that is intended to fix a number of issues. The code used as a base is a newer version of Pesterchum than the one in circulation, and thus has plenty of useful features that can be found in the [CHANGELOG][changes]. In addition, there are other features and improvements that have been made, and there are many more planned. Check the [TODO list][todo-done] to see what's been fixed, as well as what's [planned][todo-upcoming]. [changes]: https://github.com/karxi/pesterchum/blob/master/CHANGELOG.mkdn [todo-done]: https://github.com/karxi/pesterchum/blob/master/TODO.mkdn#tododone [todo-upcoming]: https://github.com/karxi/pesterchum/blob/master/TODO.mkdn#features ### Installation There isn't an automated installer yet, but the steps involved aren't all that difficult. #### Pitfalls * If you're on a 64-bit system (and most are these days), use those links. You can also use the 32 bit versions, if you choose, but you *cannot* mix them. * If you're on a 32-bit system but use the 64-bit installers, you'll get an error along the lines of "not a valid Win32 application", or the installer will simply fail. * This version of Pesterchum does not come compiled as an executable, and thus does not have P ython/PyQt4 packaged with it. Those are necessary for Pesterchum to run, so you have to install them manually. #### First-Time Install Download links are for Windows, but a quick Google search will find everything necessary. 1. Install **Python 2.7** or higher if you don't already have it: * [32 bit][python2-32] * [64 bit][python2-64] Be **sure** to add Python to the PATH if asked to do so during installation. It means Python will be usable from the console, which is necessary for this to run. 2. Install **PyQt4**: * [32 bit][pyqt4-32] * [64 bit][pyqt4-64] 3. **(LINUX)** Install **pygame**: * [pygame download page][pygame-dl] * You don't need to install this if you're using Windows. Linux users need to install it to enable sound, but it will otherwise work without it. * If you want to download this, you should probably do so using your native package manager. 4. Download **Pesterchum**: * [Download from main branch][pchum-zip] 5. Unzip Pesterchum somewhere easily-accessible. 6. **If you have any custom themes**, copy/paste them into the 'themes' folder. You can find this in `%LOCALAPPDATA%\pesterchum`, which is the same as `%APPDATA%\..\Local\pesterchum`. Copy/paste one into Explorer's address bar and you'll end up where you need to be. Oftentimes the 'themes' folder doesn't exist in Pesterchum's user-specific config folder, so you'll have to make it and copy the custom themes into it. __If, for some reason, that doesn't work:__ You can also copy the missing themes into the 'themes' folder of the version you just unzipped. **Don't overwrite any files** if you do this - the themes used by this have been updated, and the older default themes may break when used. 7. Run Pesterchum! How you do this depends on the OS: * **(WINDOWS)** Run `w32-run-pchum.bat`. * **(LINUX)** Run `./pesterchum`, preferably via terminal. * Note that this is made to provide debugging information - so that if errors come up, they can be reported to me, and I can fix them. [python2-32]: https://www.python.org/ftp/python/2.7.12/python-2.7.12.msi [python2-64]: https://www.python.org/ftp/python/2.7.12/python-2.7.12.amd64.msi [pyqt4-32]: http://sourceforge.net/projects/pyqt/files/PyQt4/PyQt-4.11.4/PyQt4-4.11.4-gpl-Py2.7-Qt4.8.7-x32.exe [pyqt4-64]: http://sourceforge.net/projects/pyqt/files/PyQt4/PyQt-4.11.4/PyQt4-4.11.4-gpl-Py2.7-Qt4.8.7-x64.exe [pygame-dl]: http://www.pygame.org/download.shtml [pchum-zip]: https://github.com/karxi/pesterchum/archive/master.zip #### Upgrading **NOTE: This only applies to those who already have this patched Pesterchum installed.** **DO NOT extract this into a folder containing pesterchum.exe, because it WILL break.** Read up to **First-Time Install** if you're installing this version for the first time. Otherwise... Just re-download the [Pesterchum zip][pchum-zip] and extract it over your old installation, replacing everything that was already there. That's all there is to it! #### Having Problems? I can't offer much help in this regard; if you're getting errors, feel free to try to contact me, but if you're having trouble with the installers, there's little I can do. [How to install Python][howtogetpython] might help; failing that, Google saves lives. [howtogetpython]: http://www.howtogeek.com/197947/how-to-install-python-on-windows/ SMILIES ------- None of the smilies have changed or been added, yet; this list is kept for posterity and easy reference. * `:rancorous:` * `:apple:` * `:bathearst:` * `:cathearst:` * `:woeful:` * `:pleasant:` * `:blueghost:` * `:slimer:` * `:candycorn:` * `:cheer:` * `:duhjohn:` * `:datrump:` * `:facepalm:` * `:bonk:` * `:mspa:` * `:gun:` * `:cal:` * `:amazedfirman:` * `:amazed:` * `:chummy:` * `:cool:` * `:smooth:` * `:distraughtfirman:` * `:distraught:` * `:insolent:` * `:bemused:` * `:3:` * `:mystified:` * `:pranky:` * `:tense:` * `:record:` * `:squiddle:` * `:tab:` * `:beetip:` * `:flipout:` * `:befuddled:` * `:pumpkin:` * `:trollcool:` * `:jadecry:` * `:ecstatic:` * `:relaxed:` * `:discontent:` * `:devious:` * `:sleek:` * `:detestful:` * `:mirthful:` * `:manipulative:` * `:vigorous:` * `:perky:` * `:acceptant:` * `:olliesouty:` * `:billiards:` * `:billiardslarge:` * `:whatdidyoudo:` [modeline]: vim:set autoindent ts=4 sts=4 sw=4 tw=79 expandtab: